home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 3.iso / dist / fw_plotutils.idb / usr / freeware / share / pic2plot / README.z / README
Text File  |  2002-01-08  |  2KB  |  32 lines
  1. This directory contains supplementary documentation on GNU pic2plot.
  2. `pic2plot' is a translator from the pic language to numerous graphics
  3. formats such as X11, PS/EPS, PCL 5, PNM, GIF, Tektronix, and to editable
  4. formats such as idraw, xfig, Illustrator, and CGM.
  5.  
  6. The pic language makes it easy to create and modify box-and-arrow diagrams
  7. of the kind frequently found in technical papers and textbooks.  It was
  8. originally designed to be translated to the troff text-processing language,
  9. so that diagrams could be interspersed with text.  The utility program
  10. `pic', the GNU version of which is `gpic', can perform this translation.
  11. It is usually invoked on the command line by doing `groff -p', where
  12. `groff' is the GNU version of the troff text-processing utility.  `gpic'
  13. can also translate pic diagrams to TeX macros, for inclusion in a TeX
  14. document.
  15.  
  16. `pic2plot' provides a third alternative.  By using `pic2plot', you may
  17. translate diagrams, written in the pic language, directly to graphics
  18. formats.
  19.  
  20. In this directory, the file pic0.ps is Brian Kernighan's original Bell Labs
  21. technical report on the pic language.  The file pic1.ps is Eric Raymond's
  22. report "Making Pictures with GNU pic", which contains additional details.
  23. Neither of these mentions `pic2plot', however.
  24.  
  25. The documentation file picmacros.ps was kindly contributed by the late
  26. W. Richard Stevens, who died on Sept. 1, 1999.  Rich Stevens wrote many
  27. fine books on programming and network programming, including `TCP/IP
  28. Illustrated' (Addison-Wesley, 1994).  picmacros.ps shows how pic macros may
  29. be used to draw diagrams (the diagrams are taken from his books).  The
  30. macros themselves are given in the file macros.pic.  Rich asked me to
  31. describe them as "work in progress".
  32.